MAXC OPFRATIONS 

Flala, Goschke, Heckel, Taft 

Xerox Palo Alto Research Center 



HAXC 18.1 

Hay 29, 1974 

Pag* 1 



MAXC OPERATIONS 

Maxc 18.1 

May 29, 1974 

by 

Edward R. Flala 

Charles M. Geschke 

Paul Meckel 

Edward Taft 



Xerox Palo Alto Research Center 

3180 Porter Drive 

Palo Alto, CA 94304 





Soct 1 on 


1. 


Introduction 


2. 


Overview of the Maxc System 


3. 


Power Up 


4. 


Loading the Nova Disk 


5. 


Contonts or the 10SYS Tape 


6. 


Loading the PDP-10 Emulator 


7. 


Starting Tenex 


8. 


NVIO and ODT 



8.1. Calling NVIO 

8.2. ODT Commands 

8.3. Nova Locations of Interest 

8.4. Memory Error Locations 

8.5. NVIO Punts 

9. Midas Commands 

10. Examining and Controlling Maxc from Midas 

11 . Warm Starts 

12. Stopping Tenex 

13. Power Down 

14. Tenex Crashes 

15. Using M1cro-Exec 

16. Reading a .SAV File on H1n1 dumper Tape Into the 
Nova File System 

17. Required Format for Standalone PDP-10 Programs 

18. Running Microprocessor Diagnostics 

19. [Running PDP-10 Diagnostics] 

19.1. [Standalone] 

19.2. [Under Tenex] 

20. [Hardware Maintenance Procedures] 

20.1. [TMEM] 

20.2. [TR] 

21. Writing a New 10SYS Tape 

22. Recovery from Checkdsk Errors 

23. [Tenex File System Maintenance] 
23.1. [Bsys Operation] 



P«oe 

1 

1 

2 

3 

4 

5 

6 

7 

7 

8 

10 

10 

11 

12 

IS 

17 

18 

19 

19 

23 

26 

27 

27 

30 
30 
30 

30 
30 
30 

30 

31 

33 
33 



MftXC OPERATIONS 

Fiala, Geschke, Meckel, Taft 

Xerox Palo Alto Research Center 



23.2. [Creating and Destroying Directories] 

23.3. [Format of System Directory and Index] 

23.4. [Fixing Smashed Directories] 

24. [Assembly Procedures] 

24.1. [Tenex] 

24.2. [NVIO] 

24.3. [Microcode] 





MAXC 


18.1 


May 29, 


1974 




Page 11 


33 






33 






34 






34 






34 






34 






1 







MAXC OPERATIONS 

F1nla. r.RSchke, Meckel, Taft 

Xerox Palo Alto Research Center 



1 . Int.roduct. Inn 



MAXC 18.1 

May 29, 1974 

Page 1 



This document describes many of the conmonly used procedures for Maxc 
operation, as well as a number of unconnon procedures used during system 
debugging and maintenance. Also included are the complete operating 
Instructions for several pieces of software written at PARC and unique to 
Maxc; these Include Midas, NVIO, DHPLD, and Micro-Exec. 

"Maxc Operations" is Intended primarily as a reference document for system 
personnel. Mowever, 1n the absence of system personnel, any user should be 
able to restart Maxc from a Tenex crash using the procedure outlined In 
Section 14. 



Conventions used 1n this document: In examples In which user type In Is 
intermixed with machine typeout, the user typeln Is underlined . <cr>, <lf>, 
<sp>, and <esc> are used to stand for the carriage return, line feed, space, 
and escape keys. 



Overview of the Maxc System 



From a user terminal, Maxc looks like a PDP-10 running the Tenex operating 
system. However, this Is mostly an Illusion. Maxc 1s really a PARC- 
constructed microprocessor which emulates the complete user-mode PDP-10 
Instruction set, as well as many of the privileged instructions and the BBN 
pager operations. The Tenex system has been considerably modified to account 
for the many differences between Maxc and a PDP-10, particularly 1n the area 
of Input/output. 

The system consists of the following major components: 

A. The Maxc microprocessor itself. Besides performing PDP-10 emulation, Maxc 
also directly controls the disks. 

B. A 256K word by 48 bit MOS memory system, with hardware built In for 
correcting single bit errors In any word and detecting (though not correcting) 
double errors. 

C. Eight disk drives, each connected to Its own controller inside Maxc. 

D. A Data General Nova, which has all the other Maxc peripherals connected to 
it. Including the data line scanner (DLS), two magtape controllers with a 
total of four drives, the IMP interface supporting Maxc's connection to the 
ARPA Network, and two MCA interfaces supporting connections to all other Novas 
at PARC. 

The Nova also performs a number of other Important functions relating to 
system Initialization and debugging. It has direct access to Maxc's main 
memory (through a separate memory port) and Indirect access to all of the 
internal microprocessor registers and memories. The Nova can load microcode 
into Maxc's writeable control store, and can command Maxc to start and stop 
execution, single step, and perform a number of other useful operations. 
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The Maxc system operates under the control of a large complex of support 
software, most of which 1s described 1n this document. These programs are 
described here. In approximately the order they would be used 1f one were to 
bring up the system from scratch. 

When first booted from switches, the Nova runs under the control of DOS, the 
Data General Disk Operating System, which Is described in the pertinent Data 
General documentation. The Nova has Its own fixed-head disk, of quite 
Insufficient capacity, which Is used for storage of Nova system programs and 
other Important files such as the Maxc microcode. DOS 1s also able to perform 
I/O to magtape unit (the one directly over the Nova Itself). 

Assuming the necessary files have been loaded onto the Nova disk, the next 
program to be run 1s Midas. Midas is the loader and debugger for Maxc 
microprograms. It has a large number of commands for examining and changing 
microprocessor registers and memories and for starting, stopping, and single- 
stepping the microprocessor. Most of Its capabilities are used only during 
debugging; In the normal course of events, It 1s used only to load the PDP-10 
microcode Into Maxc, and 1t then passes control to NVIO. 

NVIO Is the program 1n control of the Nova while Tenex 1s running on Maxc, and 
contains all the necessary I/O drivers for communicating between Maxc and the 
peripherals connected to the Nova. NVIO also has a command decoder, by means 
Of which the operator may examine and change memory, start and stop the Maxc 
microprocessor, and perform a number of other operations. 

One Important NVIO operation Is to boot Into Maxc main memory and start a 
PDP-10 program called Micro-Exec. Micro-Exec has commands for performing a' 
large variety of stand-alone Maxc operations, such as setting up the disk 
configuration, copying disk packs, and (most Important) loading Tenex from 
disk and starting It. 

Most of the rest of this document Is devoted to explaining the above 
operations 1n much more detail. 



3. Power Up 



A. First look over the system and make sure 1t Is put together. Ignore scope 
probes dangling from pins but at any other appearance of inoperativeness, give 
up or get some knowledgeable person to help. 

B. Make sure the proper disk packs are mounted. The labels are on the top of 
the pack. Compare them to the chart on the wall of the control room. 3-by-5 
cards with the currently mounted pack numbers are supposed to be posted on 
each drive. Other packs are In a yellow cabinet 1n the machine room and 
should also have cards Identifying them. 

C. Turn on the disk units. Two switches need to be turned on for each unit. 
One of them 1s 1n back and Inside the cabinet and is labelled "AC power on". 
It should be turned on first. (Normally 1t Is left on.) Then turn on the 
obvious switch on the front panel. Two minutes will elapse before the green 
light goes on. The read-only switches on the control panel should also be 
off. 
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* Note that, if a unit is selected, the read-only restriction will remain In 
force until it is deselected. This is indicated by the read-only light on the 
panel. Don't worry if the read-only light remains on, since the unit will be 
deselected by firmware later on and the read-only light will go off at that 
time. However, be sure the read-only switch is in the off position. 

D. Turn on the Nova power, Nova magtape unit power, and Nova disk power. 
(Normally these are left on so you won't have to do this.) The switch for the 
Nova disk unit 1s under the little table in front of the Nova. 

E. Turn on the Maxc microprocessor and memory as follows: Plug 1n the memory 
fans in back of Maxc. Then turn on the microprocessor fan, two microprocessor 
power supplies, and four memory power supplies 1n front of Maxc. 



the Nova Disk 



A. Get the current "10SYS" tape from the tape rack and mount It on unit 0. 
Note that the tape unit directly above the Nova should be set to unit and 
the one to the left of that should be set to unit 1. Unit 1 1s a 7-track 
drive appropriate for mounting any Tenex mlnidumper tapes you may have. Unit 
1s a 9-track drive used for Nova tapes. Set the Nova console switches to 
100022. Make sure the tape drive(s) are in remote and at the load polnt(s). 

* It is customary to hang the tape Jacket on the door of unit 1, and for 
novices to remove the write ring from tapes. 

B. Push RESET - then PROGRAMLOAD on the Nova front panel. It should ask: 

FULL(O) or PARTIAL(l)? 

and you should type which will clear the Nova disk directory, read-In • 
fresh copy of Nova DOS from magtape unit 0, and rewind the tape. 

"Note that the Nova tape on unit must be at the load point for this to work. 

C. There will be sufficient Nova disk storage to keep a copy of Nova DOS on 
the disk only if you don't plan on doing any microcode patches while running 
the system and 1f you aren't concerned with file storage for any other reason. 
To do this, type the following: 

XFER M10:l NSYS.SV; CHATR NSYS.SV SPW; INSTALL NSYS.SV<cr> 

Then set the Nova's console switches to 100020. The effect of this Is to 
cause a quicker disk restart when you push RESET-PROGRAM LOAD-CONTINUE on the 
Nova front panel switches. If you don't do this, leave the switches at 
100022. Both kinds of restart are described under the "warm starts" section 
later . 



D. You will now need to load files from tape unit 0. Normally this Is 
accomplished by loading all the files from the most recent SYSF and CHANGEF 
records. I.e. the ones with the highest numbers. The tape jacket label 
directs you to these records with some comment such as 
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TBOOT 

1 NSYS 

2 BA5EF 

3 SYSF 

4 CHANGEF 

7 CHANGEF 

Loading Is accomplished by typing: 

LOAD/A/V HT0:(1,J) <cr> 

where 1 and J are the numbers of the most recent (highest-numbered) SYSF and 
CHANGEF records as Indicated on the tape jacket. This will result 1n loading 
onto the Nova disk all of the files used by the system. The names of the 
files will be typed out as they are loaded. Hake sure there are no read 
errors typed out while loading. 

When you are done loading type 

RELEASE HT0<cr> 

to rewind the tape. The tape must be at the load point for a subsequent warm 
start If NSYS.SV has not been loaded. Normally NSYS. SV 1s loaded and the tape 
should bo replaced on the tape rack. 



5. Contents of the 10SYS Tape 



BA5EF record (only needed for debugging -- files may vary) 



DG01.MB 

OGP.MB 

DGIMH.HB 

DGIML.MB 

DGRL.HB 

DGI.MB 

DGH.MB 



R0G01 

RDGP 

RDGIMH 

RDGIMl 

RDGRL 

RDGI 

RDGH 



Current SYSF record (must be loaded) 



STOP.SV 
EDIT.SV 
TCON 



GO.SV 

TENLOAD 

SYS.HB 



DGMR.MB 


RDGHR 


DMPLD.SV 


MTAPE.SV 


MICRO. SV 


TEST 


OMICRO.SV 


LOSYS 


EMICRO 


BASEF 


DBEG.MB 


HAINM 


MAINI.MB 




HIDAS.SV 


BRK.MB 


TENGO 


UNBRK.HB 


SYS. ST 


SYSF 



Current CHANGEF record (must be loaded) 

PATCHES PATCHES. MB NVIO.SV 



CHANGEF 



There may be other files of Interest to you on Nova tapes. 
fll© FOO from any record n of the tape by typing 



You can load a 



LOAD/A/V HT0:n FOO<cr> 
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However, there 1s a limited amount of storage on the Nova disk, so you Should 
not load more than one or two small prograns at a time. 

The Nova command 

DISK<cr> 

should show 180 or more free disk blocks (300 or more 1f you plan to Changs 
the microcode) when you are done loading. This storage will be used by Nova 
DOS's program overlay feature when you run the system. 

Note: Even though you begin operation with this number of free disk blocks, 
over 150 of them will disappear when you run the system. These blocks will ba 
reused if you have to warm-start the system as described later, so don't worry 
about these disk storage numbers except during cold start. 



Loading the PDP-10 Emulator 



After loading all relevant files from the 10SYS tape, dismount and put away 
the "10SYS" tape. Then type 

GO; MIDAS TENGO<cr> 

Running the GO program may be omitted 1f the memory 1s already going (sea 
below about memory lights), and It probably causes less wear 8nd tear on tha 
memory to avoid GO In this case. 

The GO program turns on power supplies and configures the memory. It usually 
types out a moderate number of memory errors on the Haxc console. Do NOT 
worry about errors of type 1 or 4 since they are correctable. Any other error 
type may be serious and a hardware maintalner should be contacted Immediately 
1f a second attempt to run GO produces similar results. Periodic memory 
maintenance replaces bad chips 1n the memory before double errors develop. 
However, occasionally GO goes off the deep end and types reams of errors (mora 
than 10). If It does this, type control-A. This gives control to tha Nova 
debugger. Open location 411 and Insert a -1 by typing: 

411/ 1SZ PMAINT+60 -Kcr> 

Then type control-A and try again. 

After GO runs, Midas will run through the TENGO command file which loads tha 
microcode, displays some junk on the Infoton, and starts up the system. This 
takes several minutes. 

After loading the microprocessor, TENGO resets the machine (21 ;G) and checks 
the microcode (?5;G). The microprocessor may crash (IMA=20) 1f there were any 
failures detected during loading. LM 10 will contain the address of the 
clobbered word (1f only one word was clobbered). Note the values of LH 10 and 
IMA 1n the log and call system maintainors If the microprocessor crashes. If 
you cannot get the system maintalners, get out of Midas by typing control-A 
and repeat MIDAS TENGO, since hardware flakiness has been known to cause loads 
to fall spuriously and you may be lucky on the second try. If tha load 
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succeeds, then 1t boots In Micro-Exec from one of the Maxc disks and the 
console terminal types out: 

H1cro-Exec, Ver <version Identifying string) 

• 

Micro-Exec immediately executes an automatic "Go" command, which causes Tenex 
to be loaded from disk and started. Further procedures are described In the 
next section. 

If It 1s desired to load the microcode without starting NVIO or Micro-Exec, 
use the TENLOAD command file Instead of TENGO; i.e. type: 

GO; MIDAS TENLOAD <cr> 

TENLOAD 1s Identical to TENGO except that 1t does not start NVIO, Micro-Exec, 
or Tenex. 



7. Starting Tenex 



The xurrent Micro-Exec normally has been setup to have the current disk 
configuration. If you doubt this, type: 

P D C <cr> 

and It will print out the current disk configuration. Compare this to the 
chart on the wall of the control room. If you are confident, type: 

GO<cr> 



which will boot 1n Tenex from the disk and start It running. 

Tenex will ask for date and time. (The prompt specifies the format.) Please 
be careful to enter this correctly. If Tenex asks you to reconfirm your' 
typein, you probably blew 1t and you should hit "Del" and try again. (But 1f 
you are really sure you typed the correct date and time, confirm with carriage 
return). 

Tenex then runs the Bsys and Checkdsk programs to verify the consistency of 
the file system. This takes about ten minutes (the time 1s proportional to 
the number of files In the entire system), at the end of which 1s broadcast 
the message "Tenex 1n operation" If all is well. If any uncorrectable errors 
have been detected, the message "Tenex not available: Disk needs fixing" will 
be broadcast. If this occurs, you should attempt to notify system personnel. 
As a last resort, consult Section ZZ for Information on fixing errors of this 
sort. 
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NVIO and OPT 



NVIO Is a Nova Input-Output package which does all the Input-Output for Maxc 
except for the disk. Specifically it does Input-Output for the Data Line 
Scanners, the IMP (ARPA Network), the MCA (Multiprocessor Communications 
Adaptor), and the Tape Units. It also has an octal debugger called 00T (Octal 
Debugging Tool) which will allow the user to change memory locations 1n Maxc 
and the Nova, and perform other control functions. 



8.1. Callin g NVIO 



NVIO can be called from Midas with the command: 

6,NVIO;T 
or: 

!NVIO.SV/a/b ... <unitno><cr> 

where /a/b etc. represents switches (of the usual Nova DOS type); and 
<unitno>, If It exists, is of the form 'Un' for n=0 to 7. The NVIO startup 
procedure is determined by the setting of these switches, the function of each 
of which is now defined -- In the order in which they are tested to avoid any 
ambiguity caused by multiple switch settings. Each of the switches has an 
analogous ODT command with the same (letter) name. 

/B Micro-Exec Is Booted from Save Area 1 of disk unit n (from the 'Un' 
argument), where 0=A, 1=B, ... 7=H. Unit A Is used If no unit is 
specified. 

/S Tenex Is Started up, first booting Micro-Exec from disk as for /B and 

then executing an automatic "Go" command. 

/E The Maxc Micro-Exec is brought in from tape unit number n (froa Un) 
or from unit 1f no unit is specified. 

/P Protect mode 1n ODT 1s sot. This means that ODT will allow only 
those commands which examine (but do not write Into) memory and that 
do not change machine state. 

/D The Nnva Debugger will be given control. ODT Control can be resumed 
by typing SP. 

/H Normally NVIO then sends a proceed to Maxc which was halted before 
NVIO was called. This proceed can be suppressed by using the /H 
switch. 

/W NVIO will Walt for an IORESET before proceeding. 

Normally, NVIO Is Initially started up with the /B or /S switch set. In order 
to load Micro-Exec and possibly start Tenex. When It 1s desired to start NVIO 
without resuming Maxc (e.g. to examine Maxc main memory or start at an 
alternate address), the /H switch should be used. 
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8.2. 



ODT Conrvinds 



When NVIO 1s functioning, ODT (Octal Debugging Tool) 1s Its highest priority 
process (only Interrupts take precedence). It has two heralds, a number sign 
(#) which Indicates that only commands that examine memory are legal, and a 
colon (:) which indicates all commands are legal. 

If Tenex 1s running and no ODT commands have been typed for ten seconds, NVIO 
w11l continuously display and update the addresses and contents of five Maxc 
main memory variables. If you start typing on the Infoton, NVIO will stop 
doing this and will print the appropriate herald followed by your typeln on 
the next line. 

ODT connands consist of a single letter or other special character, optionally 
preceded by a nunerlc argument. The argument 1s an octal number of 16 or 40 
bits (depending on the command) or an expression made up of such numbers and 
the operators "+" and "-". ."." stands for the current (most recently 
displayed) memory address. 



Many NVIO commands request confirmation with 
character 1s a period. 



.OK" 



The confirming 



n] Change the current machine to the Nova; change the current location 
to n; and print out the current location. 

n[ Change the current machine to Maxc; change the current location to n; 
and print out the current location In the format: 

aa bbbbbb cccccc 
where: 

aa (0 to 17) 1s the last 4 bits of the 40 bit Maxc memory word, 

it is not printed out 1f zero; 
and 

bbbbbb and cccccc are the left and right half 18 bits of the 

POP-10 (Maxc) word. 

n/ Change the current location to n; and print out the current location. 

/ Print out the current location. 

n<cr> Put n Into the current location. If the current machine 1s the Nova, 
a 16 bit number 1s permissible. If the current machine 1s Maxc, a 40 
bit number is permissible. The first 4 bits Input are the last 4 
bits of the memory. Thus one can think of Maxc as a 36 bit machine 
(like the PDP-10), right adjusted In a 40 bit field, rather than a 36 
bit machine left adjusted 1n a 40 bit word as 1s actually the case. 

This command Is only legal after a command which prints out a Maxc or 
Nova location. 

<lf> (If means linefeed). Change the current location to the current 
location plus 1, and print out the (new) current location. 

n<lf> Equivalent to n, <carr1age return), <11nefeed>. 

t Change the current location to the current location minus 1, and 
print out the (new) current location. 

fit Equivalent to n, <carr1age return>, <up arrow>. 
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<tab> Change the current location to the location pointed to by the current 
location. Print out its contents. 

B Boot Micro-Exec from Save Area 1 of physical disk unit A. 

nB Boot Micro-Exec from Save Area 1 of physical disk unit n (0*A, 1«B, 
etc.) The parameter n Is remembered for subsequent *B # commands 
without arguments. 

D Go to the Nova Debugger. $P will resume ODT. 

E Startup the Maxc Micro-Exec, loading from Tape Unit 0. 

nE Startup the Maxc Micro-Exec, loading from Tape Unit n. 

nG Go to Maxc location n. Precisely: stop the Maxc microprocessor 
(cleanly if possible), then tell It to begin executing POP-10 
Instructions at Maxc main memory location n. 

H Halt Maxc (cleanly 1f possible). 

I Initialize NVIO. 

M Halt Maxc (cleanly 1f possible) and return control to Midas. 

nM Go to Microprocessor location n. (If you use this command you had 
better know what you are doing.) 

P Protect NVIO. The herald becomes a number sign (#); only those 
commands that examine memory (and other state varlbles) are legal. 

nP If the number typed 1s the Pass(word) number: ODT becomes 
unprotected; the herald becomes a - colon (:) and all commands are 
legal. Currently the pass(word) number Is 3301; this should be easy 
to remember as 1t Is the smallest number which Is the sum, of two 
different cubes 1n two different ways. (14 3 ♦ l 3 * 11"* ♦ 12 3 ; octal 
of course . ) 

Print out the current state of Maxc (running, stopped, or at a micro 
breakpoint). 

R Run Maxc (the microprocessor Is told to proceed). If a reset was 
previously done ("21M" to ODT or "21 ;G" to Midas), POP-10 
Interpretation will begin at the starting address pointed to by main 
memory location 7; otherwise, Maxc will resume from where It was 
halted. 

nR If n Is zero, disable Maxc main memory error recovery; NVIO will 
halt Instantly on any fatal Maxc error. If n 1s nonzero, reenabl* 
error recovery. 

S Startup Tenex, booting M1cro-Exec from disk unit A. 

nS Startup Tenex, booting Micro-Exec from disk unit n (0=A, 1=B, etc.) 

nT Begin Testing output on DLS line n. 

nU Unhang Nova device number n by simulating a completion Interrupt. If 
you use this command you had better know what you are doing. 
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nZ 



Stop testing DLS line n. 



8.3. Nova locations of Interest 



50: Version number. This number Is Incremented by 100 for each assembly 
of NVIO. 

51: Normally this location has a -1. If 1t has the number n In It then 
NVIO will PUNT 1f it attempts to read or write Into Haxc physical 
page n. 

52: The pass(word) number. Currently this 1s set ot 3301 as explained 
under the ODT command P. 

53: Date of most recent NVIO assembly, 1n the form MMDDYY, where MM and 
DO are octal but YY Is decimal (at least until 1978). 

55: Save area to boot Hlcro-Exec from (usually 1). 

56: Default disk unit to boot M1cro-Exec from (Initially 0, but changed 
by arguments to B and S commands). 

The following symbolic locations are of interest: 



RTM: 
H: 



BREAK: 



location of code to return to Midas. The Nova debugger 
commands RTNSR or MSR are equivalent to the ODT command M. 

location to goto to make a save file of the current version of NVIO. 
After BREAKSR 1s executed, control will go to the Nova Exec and the 
command: 

SAVE name 

should be executed to save NVIO on the specified file. This -1s 
normally done after NVIO 1s patched by the following sequence: 

DEB NVIO 

make patches 

BREAKSR 

R 

SAVE NVIO 

If control goes to a debugger breakpoint after the BREAKSR 1s 
executed, this means that there 1s no disk space available. Exit via 
RTNSR; make disk space; and repeat patches. (Sorry!) 



8.4. Memory Error Locations 



The following locations are updated whenever a fatal Maxc error Interrupt 1s 
processed by NVIO. They are listed 1n the order in which they occur. 



SE 
DE 



Single Error 
Double Error 



The format of each of these 
words Is wxyz where w can be a 
or 4; x, a, or 1; y a or 
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DIP Data Input Parity 

APE Address Parity Flag 

PBF Parity Bit Flag 

TIME Timeout 

LSE Last Single Errors 

LDE Last Double Errors 

DIP Last Data Input Parities 

LAPE Last Address Parity Flags 

LPBF Last Parity Bit Flags 

LTIME Last Timeouts 



7; and z a or 3. This number 
specifies the quadrant that has 
had errors (4 meaning quadrant 
0). Thus SE/ 4003 means that 
there were single errors in 
quadrants and 3. Each fatal 
error Interrupt causes the 
errors to be ored Into the 
first six words, and stored 
Into the last six. 



SEOC Single Error Count for quadrant 
DE0C Double Error Count for quadrant 

TIME0C Time out Error Count for quadrant 
SE1C Single Error Count for quadrant i 

SE2C Single Error Count for quadrant 2 

TIME3C Time outs for quadrant 3. 

There are (6 times 6 equals) 36 locations In this memory error block. 

8.5. NVIO Punts 



For each PUNT, the location at which the PUNT occurred Is put Into Nova 
register 3, and information particular to each PUNT Is sometimes stored In 
register 0. Haxc is then halted (cleanly if possible) and "NVIO Punt" 1s 
printed on the Nova console. 

Accumulators 0, 1, 2, and 3 are stored at PUNT0, PUNT1, PUNT2, and XPUNT 
respectively, and may be examined by going Into the DOS debugger with the "0" 
command. After resuming NVIO with "SP", 1t 1s necessary to restart Ten ax In 
one of the following (increasingly drastic) ways: 



1) 



.OK. 



(Simply tells Maxc to proceed). 
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2) :21H...OK. 
;140G...OK. 



(Resets Maxc microprocessor). 
(Attenpts "soft" restart of Tenex), 



3) ^...OK^ (Reloads and restarts Tenex). 
Hore detailed Information on handling NVIO punts may be found In Section 14. 



Midas Commands 



A. Conventions 

The memories accessible to Midas are called: 

MAIN (system main memory - lower 64K words only) 

LM (left register bank 32 registers) 

RM (right register bank 32 registers) 

SM (scratch memory 512 registers) 

DM (dispatch memory 512 registers) 

IM (Instruction memory 2048 registers) 

MP (map memory 1024 registers) 

These names are consistent with all other microprocessor and microcode 
literature. 

The Infoton display 1s completely controlled by Midas. The upper seven rows 
display 14 of the microprocessors Internal registers. The lower 8 rows can 
display any memory words from the memories listed above. 

A address, one of 3 forms 

1) symbol Identifier, possibly followed by blank and octal 
Increment (Increment may contain leading + or - sign) 

11) memory Identifier followed by blank and octal address 

111) octal address, presumed to be In Instruction memory 

V octal value 

P screen position 

The letter L(left) or R(rlght) followed by e decimal 
Integer from 1 to 15(row) 

F a file name. 

If It contains no period, a default extension will be 
added, as specified for each command. 

Octal values, addresses and Increments may contain embedded blanks. 

Rubout deletes the previously typed character and backspaces the cursor. 
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B. 



Commands 



In the following, some commands have two forms, with and without a screen 
position field. In the form without a screen position field, the current 
screen position is used. Unless otherwise noted, all commands with a Screen 
position field reset the current position to that specified In the current 
command. 

A[ prints out numeric value of A, In octal 

: single step 

A: single step at address A 

A/ display contents of address A at given position 
A,P/ 

<cr> displays at given position the contents of next- 
P<cr> higher address than currently displayed there 

t displays at given position the contents of next 
P» lower address than currently displayed there 

<lf> displays, at position below current position, contents of n«xt 
higher address than currently displayed at current position. 
Resets current position one lower. 

V«- store octal value into the memory word addressed or register 
V,P»- named at the given screen position 

A;B Insert a break point at given Instruction memory address 

A;K remove a break point from given address 

A;G . start processor at address A 

;P continue running the microprocessor at the current mlcroaddress 
(in IMA) 

S single step processor (same as :) 

S single step processor at address A (same as A:) 

C repaint the screen 



F[l] F[k];R 



load files F[ 1 ] to F[k] (k>l) 
(default extension ".MB") 



1;1 "GO" (=6,GO;T) 

2;T "SlOP" (=6,STOP;T) 

3,F;T (default extension ".XX") take commands from file F until 
exhausted. May not be nested. 

4,F;T (default extension ".ST") define /R file for subsequent patch 
calls to MICRO 

5,F;T (default extension ".MB") dump state of microprocessor onto flit 
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F, for subsequent reload using F;R. State dumped consists of 
the complete IM, SM, DM, LM, and RM memories but does not 
Include the MP memory or the registers. The address symbols are 
dumped also. Reloading, the dump file takes about one minute 
ten seconds and 1t occupies about 52,000 characters on the Nova 
disk. 



6,F;T 



(default extension 
F. 



.SV) makes .EXEC DOS system call upon file 



!F<spXcr> 



<sp>TEXT<cr> 



(null default extension) 1s the same as 6,F;T except that F can 
contain spaces and slashes for constructing more elaborate .EXEC 
calls (e.g. "«NVIO.SV/B"). 

will carry out microassembly of the TEXT using the file 
specified by the last 4,F;T as a /R file for HICRO. The text of 
the patch Is appended to DBGPTCH and the binary 1s loaded. Two 
garbage files PTCHJS (text of last patch) and PTCHSJ.ST (/R file 
created by assembly) are also left. 

C. Special Information 

* ne cursor on the Infoton display will rise above the line when a command 1s 
In progress and drop down again when It Is done. 

Control-A will stop the microprocessor If 1t 1s r unning , but crash Midas back 
to the DOS EXEC 1f the microprocessor Is not running (1n which case you will 
have to restart by reloading the microprocessor). Midas can take 15 seconds 
to evaluate a new symbol near the end of a big microprogram so don't get 
inpatient and type control-A. (Reloading from a big file takes over two 
minutes.) The cursor will rise above the command line when any command 1s In 
progress. If the command Is a ;G or ;P, then the microprocessor will be 
running and control-A can be used to stop 1t. However, if you say SYMBOL ;G, 
be sure you have waited the required 15 seconds for symbol lookup before 
typing control-A. 

The firs t time you reference a symbol, Midas takes up to 15 seconds. 
Subsequent references are very fast (about 1/2 second). 

Instruction memory addresses can only be displayed In the left column of the 
display and take up the full width of the screen. 

When the microprocessor 1s stopped by control-A 1t will sometimes be possible 
to continue by ;P safely, but don't count on 1t. It 1s possible to continue 
safely from breakpoints except when the break occurs during the read portion 
of a read-mod If y-wr1te memory reference or on either of the two cycles 
following a write, 1f the memory data register has not been loaded. 

When Midas runs, it creates two temporary files called SSDBGE and SSDGBS. If 
you use the patch feature, PTCHSS, PTCHSS.ST, and DBGPTCH also get created. 
If you wish you may delete these when you return to DOS. 

Do not attempt to examine main memory locations M77777 with Midas. Midas 
will- go through the motions of examining and changing the addressed cell, but 
In fact the address will be truncated to 16 bits. All main memory addresses 
say be examined using ODT, as follows: 
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!NVIO_.SV/H <cr> 

NVIO 

:nnn_nnn/ mmmmmm mmmmmm 

:M.\ .OkV 



Starts NVIO but leaves Maxc halted. 

Examines main memory. 
Returns to Midas. 



10. Examining and Contr ol lin g Maxc from Midas 



A. Reset Is accomplished by typing 

21;G 

to Midas. The effect of this is to put the machine 1n monitor mode, to clear 
the interrupt system, the APR, the processor flags and the disk systen. 
However, Nova peripherals aren't affected, nor are the accumulators or PC 
affected. If NVIO 1s called after RESET (by 6,NVIO;T) the processor will 
start at Its starting address (pointed to by absolute location 7). 

B. Startin g at an arbitrary location n 1s accomplished by changing the 
contents of PC (which is on the display) to n and then typing 



REMAPPC: 
6,NVIO;T 



(Midas types out the value m of REMAPPC) 



C. The accumulators are LM 0, LM 1, 
changed in the usual way from Midas. 



LM 17 and can be examined and 



D - Flags arc in the left-most 13 bits of the F-register on the display. If 
you change these from Midas, don't change the other 23 bits of F. 

These and other interesting bits of F are as follows: 

Bit D efinition 

Overflow 

1 Carry 

2 Carry 1 

3 Floating overflow 

4 Byte Interrupt 

5 User mode 

6 PARC mode (replaces PDP-10 user I/O mode) 

7 Call from monitor (see JSYS, UM0VE, and Pager addenduas to 
PDP-10 System Reference Manual) 

8-10 Machine mode (0^PDP-10, l=8yte Lisp) 

11 Floating underflow 

12 No divide 

13 Pushdown overflow 
. 14 XCT0 

15 XCT1 

16 XCT2 

17 XCT3 

18 Incompatible 

19 PI system is active 

20 PI cycle in progress 
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21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 



MONALT 

THIRDPT 

MICRO 

TTYBSY 

LOGF 

Unused 

CUM 

Unused 

IENABLE 

Unused 

NOVA 

K 

J 

H 

G 



} Temporary flags used by the map loading 
} microcode 

console teletype output busy 

enables Instruction Interpreter's optional feature 



Nova has left an Interrupt request 



E. The Interrupt system state 1s given by the following: 

PISTAT[29,35] have l's when Interrupts are In progress on the corresponding PI 
levels[l,7]. PISTAT[22,28] have l's when Interrupts are disabled on the 
corresponding PI levels. 

SH 600 to SM 643 contain In the right-most 24 bits the interrupt locations 
corresponding to devices through 35. The device assignments are in Maxc 
document 11. 

SM 644 to SM 652 are the interrupt-enabled bit tables for priority Interrupt 
levels 1 through 7. l's 1n each word Indicate that the corresponding device 
(bit 0=device 35, bit 35=device 0) Is enabled for interrupts at that level. 

MICINTS contains l's for each device which has requested an interrupt. 
(However, OVF, FOVF, and P0OVF are recomputed from F for each Instruction, so 
their state in MICINTS Isn't important.) 

F. The microcode consistency CHECKER uses three variables CSUMD, CSUMO, and 
CSUM1 which contain checksums for all constants in the microprocessor's IM, 
DM, and SM memories. CSUMD is an overall checksum (for detection of errors) 
while CSUMO and CSUM1 contain 12 6-b1t bytes each of which Is a checksum in a 
Manning code. The checker computes the address which 1s clobbered assuming 
only a single word is wrong. 

When newly assembled microcode Is loaded for the first time, these checksums 
are computed by running CHECKER ("25;G" in the TENLOA0 command file) and 
entering the values left In LM 11, LM 12, -and LM 13 into the PATCHES file for 
CSUMD, CSUMO, and CSUM1. Subsequent runnings of the TENGO command file check 
the newly loaded system against these constants, and CRASH on errors. Also 
the CHECK JMC does this (executed during Tenex Initialization). 



G. Breakpoints are handled as follows: 

Two versions of the emulator's main loop are standardly available. They are 
called BRK. MB and UNBRK. MB. Each version has an optional path executed when 
the LOGF flag In F Is 1. When the microprocessor 1s loaded via MIDAS TENGO, 
the UNBRK version is loaded, and the optional path performs opcode logging 1n 
the 512-word table pointed to by LOG T. By typing to Midas BRK;R, you can load 
a version of the main loop which has facilities for single-instruction 
stepping and for breaking before executing an Instruction at a single selected 
address. The register LOGT on the display controls the breakpoint feature as 
f o 1 1 oWs : 
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address 



single-Instruction execution 
break address 



To disable the optional path and resume full speed execution, simply turn off 
the LOGF flag. 

Whenever you have broken or halted, you may switch between BRK and UNBRK. 
Note also that whenever the processor halts or breaks, the address of the next 
instruction is In P and the address of the last instruction *1 Is 1n PC on the 
display. 

However, note that the checksums which have been set up in PATCHES are for the 
UNBRK version, so you will have to recompute them to use the CHECKER with BRK. 



11 



Warm Starts 



A. If for any reason you fall out of NVIO and end up 1n Midas, you can 
continue by restarting NVIO with 

6,NVIO;l 

This 1s not recommended when Maxc Is running Tenex because I/O communication 
(particularly DLS and MCA) is almost sure to get fouled up. Instead, a Tenex 
"soft restart" should be performed, as follows: 



!NVI O.SV/H <cr> 

NVIO 

: HOG... OK. 



(Start NVIO but leave Maxc stopped) 
("Soft restart" Tenex) 



B. If you voluntarily or Involuntarily exit back to Nova DOS, there 1s no 
easy way to resume Midas. You must reload the microprocessor with either the 
TENGO command file (complete reload of microcode, reset of the microprocessor, 
and disk boot of Micro-Exec) as described under cold start procedure or with 
the TENLOAD command file and attempt to "soft restart" Tenex, as described 
above . 

The command MIDAS TCON may be used to reload the microcode and continue the 
microprocessor without otherwise disturbing its state; however, a new copy of 
NVIO will be running, so It is not possible to resume Tenex In this way. 
MIDAS TCON is useful only when the state of NVIO is unimportant when 
continuing, e.g. when running standalone PDP-10 diagnostics. 

C. If you want to dump the 10 program you have created in core, you must exit 
back to DOS (by control-A or ;X to Midas). Then dump the first 32K of Mln 
memory by typing 

DFB DMPLD 

OMPLDX 

DUMPSR 



The program will then ask DUMP TO FILE: and you should type a file naae. If 
you make a mistake type rubout and try again. 

D. To load a PDP-10 .SAV program when you are in Nova DOS type 
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DMPLD<cr> 

and answer the LOAD FROM FILE question. Type rubout and try again 1f you make 
a mistake. This zeroes the first 32K of main memory before loading. 

If you are 1n Midas, type 

6,DMPLD;T 
When DMPLO returns to Midas you may type 

;C 

to repaint the screen. 

E. If the Nova disk gets cluttered you can DELETE files (see Nova DOS 
documentation). Note that the available disk storage will shrink when you run 
Midas due to usurptlon of disk blocks used by DOS's program overlay feature. 
These blocks will be reused by the program overlay feature, but aren't 
available to ordinary files. If for some reason you want to recover this 
storage, restart DOS by pushing RESET - PROGRAM LOAD - CONTINUE on the Nova 
front panel (tape must be at loadpolnt and switches at 100022 as discussed 
earlier or else NSYS.SV must be INSTALLed on the disk and switches at 100020). 



12. Stopping Tenex 

In order to give users adequate notice and to protect files on disk, Tenex 
should ordinarily be stopped 1n the following manner. 

As long as possible before the scheduled downtime (preferably 24 hours or 
more), notify users by putting a notice 1n the login message and by setting 
the system downtime cell. 

A. To put a notice 1n the login message, login as yourself and: 

B SNDMSG <cr> 

Users: SYSTEM <cr> 

Subject: Scheduled downtime <cr> 

Message: 

(An appropriate message giving date, time, and reason) 

11 

SYSTEM -- ok 



B. To set the system downtime cell, you must be a wheel or a maintenance 
person: 

&ENABLE <cr> ( only If you are a whee l ) 

! HALT, <cr> (do not omit the comma) 

[Superpassword: ] GUESS <cr> 

@9AT nm/dd/yy hh :nm <cr> (date & time system going down) 

eg UNTIL nm/dd/yy hh:mm <cr> (date & time system coming back up) 

99 <cr> 
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The system will automatically start notifying users of the inpendlng downtime 
bec|1nnin<i onn hour before it is to occur. When the rero hour arrives, all 
jobs will bo forcibly loqged out except those jobs logged In on either of the 
two machine room terminals, new logins will be prevented, and "Shutdown 
Complete" will type out on the Maxc console. If there are now no Jobs logged 
1n, Tenex will shortly hit a BUGCHK (EDDT breakpoint) at SWHLT1, at which 
point Tenex Is properly halted. 



If there are Jobs logged In on machine room terminals, 1t will be n 
halt Tenex manually. To do this (for which you must be a wheel ): 



ecessary to 



PFNABLE < cr> 
JQlli'l <cr> 
.Halt Tenex^ 

Walt for the EDDT breakpoint at SWHLT1. 



13. Power Down 



You should not power down the processor or the memories by pulling plugs or 
throwing switches since this sudden shut down can damage components. Only 
resort to this drastic action 1n an emergency (e.g., fire). 

Proper shut down is accomplished by running the STOP.SV Nova program first, 
then pulling plugs and turning off switches. This can be accomplished either 
by saying 

STOP <cr> 

to Nova DOS or by 2;T (=6,STOP;T) to Midas. When you run STOP, the two green 
lights on the processor and the four red lights on each memory will shut off. 
The fans will continue to run and you may unplug them at the wall. 

To turn off disks, turn off the front panel switches first. Do not turn off 
AC power (1n back) until the pack has stopped turning, else the drive may atop 
with the heads still extended! 



14. Tenex Crashes 



If a Maxc-Tenex maintalner 1s available at PARC, Inform him of the crash and 
normally he will take over. Otherwise, be brave and read on. 

There are obvious problems in attempting to describe what to do when a system 
crashes. This section simply outlines a few simple procedures whose purposes 
are twofold: (1) to collect data about the crash for subsequent analysis and 
(2) to restart the machine as quickly as possible. 
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When system personnel are not present, Tenex 1s left 1n a mode In which 1t 

attenpts recovery fron Tenex-detected errors. Thus the majority of the time 

the crashes handled by non-system people will be of a more obscure (relative 
to Tenex) nature. 

The following paragraphs describe some of the more common crashes and 
suggested recovery procedures. All pertinent Information should be recorded 
1n the Maxc Tenex logbook. Recent error typeouts (e.g. memory parity error 
messages) should be cut out and taped 1n the logbook. 

A. BUGHLT or BUGCHK : A message of the form 

S8B>>BUGA0R BUGHLT/ CAI UUOH+4 

types out on the Maxc console. This occurs when the monitor 1s In debug mode, 
which should never be the case unless system malntalners are present. 
However, if you cannot find one, set the DBUGSW and DCHKSW cells to zero and 
proceed from the breakpoint: 



<esc>P 

Tenex will recover from the error If possible, else restart automatically with 
no further intervention required. 

B. "Micro Breakpoint* printed out on the Nova console (Infoton). This and 
similar NVIO messages will usually appear above the lowest line of text and 
two lines of nunbers usually displayed by NVIO. This message means that the 
microprocessor hit a breakpoint, which 1s usually caused by Tenex executing a 
HALT instruction but can also be caused by any of several microprogram- 
detected inconsistencies. 



The only known HALT Instructions in Tenex are associated with catastrophic 
disk errors, e.g. disk units offline, and a message such as 

Sector Interrupt Timeout Trouble with Disk Pack 111 

1s typed out on the Maxc console. If this was caused by accidentally turning 
a disk off or other obvious hunan error, the crash may be recovered by the 
following procedure. 

1. Correct the cause of the error; i.e. turn on all disk units and wait 
2 minutes for the green lights to come on. There should be no yellow 
(read-only) or red (select lock) lights on. 

2. On the Nova console (Infoton), type: 



J 3301P 
:140G...OK. 



(to "un-protect" NVIO) 
(to "soft-restart" Tenex) 



All other disk errors (particularly "Error In Sensitive Page") should be 
handled by system personnel only. Attempting to restart could cause the file 
system to be wiped out! 

A "Micro Breakpoint" not accompanied by a printed message on the Maxc console 
should be handled as in Paragraph E, "No Response". 



"Fatal Memory Error, Maxc Stop 



on Nova console. This Indicates that 



the memory 1s very sick, and a hardware malntalner should be notified. 
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D. r_ N VIO Punt" on Nova console. This indicates a serious Inconsistency 
detected by NVIO. Crash data should be saved and the crash recovered as 
follows (typo on the Nova console). 

'i^OJP- ("un-protect" NVIO) 

:li...OK. (enter Nova debugger) 

XPUN1/ junk ^.sssss+n = nnnnnn < l_f> 
PUNTO/ junk ^sssss+n ^ nnnnnn <"lf > 
PUNT1/ junk ^sssss+n = nnnnnn <lf > 
PUNT?/ Junk ^sssss+n 2 nnnnnn <cr> 
<escJ>P (Resune NVIO) 

:R.".Ok\ (Resume Maxc) 

If Tenox docs not resume after this procedure, try a "soft restart" by typing: 

:1_40G. ..OK^ 

on the Nova console. 

Write down in the logbook the data typed out by the debugger 1n response to 
the ":" and "=" characters you typed in. 

E. No response from Tenex; I.e., no error messages have typed out, but 
nothing happens when you type control-C on the Maxc console. This type of 
crash is particularly hard to diagnose unless sufficient Information Is 
recorded. 

First, note the numbers on the last Hne of the Nova console, and note whether 
any of them are changing over time. 

Second, enter Midas by typing the following on the Nova console: 



* 330 IP 
:M". T.OK. 



(to "un-protect" NVIO) 
(to enter Midas) 



(If the message "Unclean Micro Stop" prints out, note this as well.) Write 
down the contents of the following registers displayed by Midas: 

NPC IMA P STK PC PISTAT 

Of particular importance 1s PC, the PDP-10 program counter. 

Third, type the Midas commands: 

<LL;G 
?h;G 

to reset the microprocessor and check the microcode. Both commands should 
finish momentarily with IMA=27 or 30. (If IMA=20, the microcode has been 
clobbered and you will need to reload It, as explained 1n step F below.) 

Fourth, re-boot Maxc by typing: 

!NVIO.SV/B <cr> 

The M1cro-Exec herald should type out on the Maxc console. 

Fifth, pick a save area on which to dump the crashed Tenex. Save areas 10 
through 17 are used for this purpose. Look through the last page or two of 
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the Maxc Tenex logbook to see what areas already contain recent crash dumps 
(1f any), and pick an area that hasn't been used. Type (on the Maxc console) 
the command: 

* Dunp. Core .on. Area n <cr> 

where n is the save area you have selected, and note 1n the log that the crash 
was saved on area n. 

Finally, type: 

•Go <cr> 

to reload and restart Tenex. After a few seconds, "Tenex restarting, wait..." 
should be typed out and Tenex will request the date and time, which you should 
type 1n very carefully. If Tenex asks you to reconfirm, you probably blew 1t 
and should hit the "Del" key and try again. 

F. It may happen that a crash does not fall Into one of the above categories 
or that the restart procedure falls. In this case, the following procedure 
will always succeed if all the hardware Is working: 

i. On the Nova front panel 1n the machine room, press, 1n sequence, 
"Reset", "Program Load", and "Continue". On the Nova console, you 
should see: 

DOS REV 04 
R 

2. Type the command: 

GO; MIDAS TENGO <cr> 

3. Walt about Z minutes while the microcode loads and NVIO and Micro- 
Exec are started. Micro-Exec will execute an automatic "Go" command, 
after which you should enter date and time as explained above. 

If this doesn't work, try to find any one of the people listed below at PARC. 
If none of then Is around and the hour is between 9 AM and midnight, call one 
oT the system malntalners. If between midnight and 9 AM, don't bother, but 
leave a message on the telephone recording (if you know how) saying that the 
machine will be .down until morning. 

People to notify : (use phone list on wall under phone) 



Software and 


general system maintenance 


Taft 

F1ala 

Geschke 




Tenex and NVIO 
Microcode and Tenex 
General 


Hardware 






Lampson 
Clark 
McCreight 
Thacker 


Microprocessor 

Memories 

Disks 

Almost anything 



MAXC OPI RA1IONS 

Mala, fioschke. Ilpckel, liiTt 

Xerox Palo Alto Research Center 



MAXC 18.1 

May 29, 1974 

Page 23 



Us ing M io o-I yec 



Micro-Exec Is a stand-alonr. Maxc program used to maintain and start up the 
Maxc Tenex system. A few overall remarks on its structure will be helpful 
before describing the specific facilities available. 

Micro-Exec is normally loaded by the TENGO command file (see section 4) fro« 
Maxc disk unit A. Micro-Exec loads into the high portion of the first 128tC of 
memory, starting at 350000. All references to "core" in M1cro-Exec commands 
refer to the range 20-10-347777. (Ihe program which boots In H1cro-Exec runs 
in 347000-347777 and saves the previous contents of the ACs In 347760-347777.) 

Micro-Exec has a sophisticated command interpreter which allows editing, 
questioning, prompting for parameters -- what we 1n the b1z call "Dwlmlfled- 
Middle-Engl ish" . Commands take the form of a sequence of words separated by 
periods. E.g. : 

Initial ize. disk. pack 
or 

Initial ize. tape. 

At any point in typing a string, you may type <escape> and the Interpreter 
will complete as much as is unambiguous. Similarly, at any point you may type 
"?" and all the possible completions of that command will be listed. Once you 
arc familiar with commands, you will find it convenient to abreviate them by 
entering the first letter of each word followed by a space. For example, 
I D P is an abbreviation for " in i t ial ize .disk .pack" . 

Many of the commands require parameters before the command execution begins. 
Typing an escape will prompt you with a brief description of the parameter 
(e.g., (octal number) or (pack number)). Typing escape a second time will 
furnish the default value of that parameter 1f there 1s one. Some commands 
require confirmation (with .) and some require the user to be ENABLEd. The 
ENABLE command requires a password. 

Finally a few words on the disk structure of the Maxc-Tenex system will be 
helpful for the following command descriptions. A disk configuration is 
defined by establishing a correspondence between (1) logical units (Tenex), 
(2) pack numbers, and (3) disk drives (i.e.. controllers). The current disk 
configuration is always posted on the control room wall and Is (usually) the 
default configuration on the current M1cro-Exec save area (usually area 1 on 
physical unit 0). Logical units arc identified by digits thru n-1 (for an 
n-pack Tenex). Packs are labeled with octal numbers starting at 100. Drives 
are labelled alphabetically starting with A. For example, the 
"print .disk .configuration" command might type: 



Number of units: 
Unit 

0. B 

1. A 



-Pack Number 
102 
107 



At present there are 20 AREAS allocated in the disk structure, but outside the 
Tenex file system. Each AREA consists of four track cylinders (I.e., 240 
(decimal) pages). A directory of AREAS Is posted on the control room wall. 

In the following descriptions, a (C) means confirmation 1s required (E) neans 
you must be enabled, and (C,E) means both are necessary. In commands that 
read from or write to disk, the number following the command Indicates the 
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error retry count used; "default" means that the retry count may be 
overridden by the count specified in the "set. disk. error. retry. count" command. 



brief 



Disables extended typeout of disk error status bits. 



change. version. to <string> (E) 

Changes the version description for M1cro-Exec. 

check. next. tape. file <magtape unit nunber> 

Checksums next file on tape and types entry point on console. 

clear. core (C) 

Zeros locations 20 through 347777. 

compare. disk. packs <pack.> <pack-> (20) 

Compares the contents of the specified packs and reports 
discrepancies (usually used after a pack-to-pack copy). 



copy. pack. to. pack <pack.> <pack-> (C.E) (default 20) 
Does a bli-by-blt copy of data from fl 



irst pack onto second pack. 



copy. quadruple <pack,> <pack 2 > <pack 3 > <pack 4 > (C,E) (20) 



ddt (E) 



disable 



Simultaneously copies the first pack onto the second pack and 
the third pack onto the fourth pack. 



Enters DDT for debugging Micro-Exec. Re-enter Micro-Exec by 
20SG. 



Disables commands that require being enabled. 



d1smount.aux111ary.pack 

Removes auxiliary pack from disk structure. 

dump. core. on. area <area> (E) (20) 

Dumps locations 20 through 347777 on <area>. Registers are 
saved at 347760 when M1cro-Exec Is booted in. This command Is 
used to save crashes for later analysis. 



eddt (E) 



Enters Exec DDT If Tenex Is In core. Re-enter M1cro-Exec by 
typing 205G. 



enable <password> 

Enables user to execute those commands which require 1t. 
Current password 1s SIEGFRIED. (Currently, when M1cro-Exec 1s 
booted In, 1t 1s already enabled, so this command Is necessary 
only If you have previously given a "Disable" command.) 



90 (20) 
help 



Loads Tenex from area and starts 1t at SYSGOl. 
Counsels you on the method of obtaining help. 
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Initialise. disk. pnck (C) (default 0) 

Initializes the auxiliary pack by: (1) writing headers, using 
the pack nuntinr entered in the mount .auxl 1 1ary. pack command, (2) 
writing random data on the entire pack, and (3) checking the 
data and printing discrepancies. An error retry count of zero 
is used throughout. 

Initial 1ze .tape <magtnpe tinit> (C.E) 

Rewinds tape to load point, writes a boot header, and waits at 
the end of the boot header. 

load. dump. from. area <area> (20) 

loads core from specified area (converse of dump. core. on. area ) . 

loop. on. specif ied. disk. page <pack> <track> <head> <sector> (E) 

Continuously reads the specified disk page Ignoring •rrors 

(useful for disk tune-ups). 

mount. auxll lary. pack <unit> <pack> 

Identifies auxiliary (I.e.,- extra-Tenex) pack to disk 
configuration. Certain commands such as Initialize. disk. pack 
are valid only for the auxiliary pack. 

print. disk. con figuration 

Prints disk configuration in the format Illustrated above. 

road. specif led. disk. page <pack> <track> <head> <sector> (default 20) 

Reads specified page into buffer at location BUT (377000). 

read. tape. to. core <magtape unit> 

Reads tape into core starting at location 20. 

read. tenex. from. area <area> (20) 

loads Tenex from specified area and checks Its "fingerprint". 

read. tenex. from. tape <magtape unit> 

toads Tenex from tape and checks Its "fingerprint". 

rewind. tape <magtape unit> 

scan .disk. pack. for .errors <pack> (default 3) 

Scans pack, counting soft errors, and reporting non-recoverabla 
errors to console. 

set .disk. configuration (E) 

Sets disk configuration; asks for parameters via th« Sana 
format used in print .disk. configuration. 

set .disk. error .retry .count (E) 

Overrides the default disk error retry count 1n certain 

commands. 



silent (C,E) 



Completely turns off disk error typeouts (useful for setting up 
scope loops for hardware debugging). 



start. tenex. from. area <area> (C,E) (20) 

Reads Tenex from the specified area, writes It on area 0, and 
starts at SYSGOl. 
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verbose 



Reinstates full disk error typeout. 



write. core. to. tape <magtape un1t> 

Writes core from 20 to 347777 onto tape. 

write. micro. exec. to. area <area> (C.E) (20) 

Writes a bootable (via NVIO "B" and "S" commands) copy of the 
currently running Micro-Exec to the specified area. 

write. micro. exec. to. tape <nagtape unit> 

write. specif led. disk. page <pack> <track> <head> <sector> (C,E) (default 20) 
Writes page from BUF (377000) to specified disk page. 

write. tenex. to. area <area> (C.E) (20) 

After checking "fingerprint", writes Tenex core Image to 
specified area. 

write. tenex. to. tape <magtape un1t> (C) 

After checking "fingerprint", writes Tenex core Image to 
specified tape. 



16. 



Reading a .SAV File on Mlnidumper Tape Into the Nova File 
System 



PDP-10 Diagnostics and other stand alone PDP-10 programs which reside only 1n 
the low 32K of main memory may be read from mlnidumper tapes and written on 
Nova disk files using the MTAPE program. Subsequently they may be loaded Into 
main memory and dumped back on disk files using DMPLD. The procedure 1s 
described below. 

To load from mlnidumper tape, first mount the tape on the Nova's seven-track 
tape drive (unit 1) and put If in remote. Then give control to Nova DOS .and 
type the following: 

DELETE TENCODE.SV 
MTAPE<cr> 

which will ask "LOAD FROM FILE:". You should answer with a unique Initial 
substring of the file name. For example, <SYSTEM>AUXD.SAV<cr>. MTAPE will 
copy this file onto TENCODE.SV which you can rename as follows 

RENAME TENCODE.SV AUXD<cr> 

Normally you will have to prepare locations 3, 4, and 7 as discussed 1n 
section 13 before running the program. To make these changes, proceed as 
follows: 



DMPLD<cr> 

LOAD FROM FILE: 

NVIO/H<cr> 

3/ NNNNN<Lf> 

4/ NNNNN<cr> 



AUXD<cr> 
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II NNNNN<cr> 
M . . . OK . 

III It PMPlD<cr> 
DMPM.nX 
DMMPSR 

DUMP TO FILE: AUXX<cr> 

The file will normally grow by a substantial amount when this Is done because 
DMPLD does not compress out zeroes when dumping. 

DELI TF AUXD<cr> 
RENAME AUXX AUXD<cr> 



17. Required F orma t for Standalone PDP-10 Programs 

A. The loader (DMPLD) discussed 1n the previous section requires the program 
to be a .SAV file which resides 1n the low 32K of main memory. DMPLD 
currently rcrocs the low 32K of core before loading the program. 

B. The Interprocessor communication locations must be set up with pointers as 
follows: 

3/ MTBS Magtape, IMP, MCA. etc. 144-word block (may grow later) 
4/ DLSBS Data line scanner 68-word block 
7/ ADDRESS Program starting address 

Note that these are absolute main memory locations in the "shadow" of tha 
accumulators, so they must be Initialized In one of three ways: 

(1) By hand from Midas or ODT 

(2) By mapping page to a different virtual address 

(3) By using the JMC's for addressing absolute main Memory 
addresses. 

C. The program must perform an I/O reset (CONO APR, 200000) before carrying 
out Input/output to any Nova related peripherals and after Initializing HTBS 
and DLSBS as described above. 



18. Biinnjjig; Mi cro pr ocess or Diagnostics 



The microprocessor diagnostics are sometimes left on the disk and are on the 
BA5EF record of the 10SYS tape (see Section 4). If they are not loaded, get 
the current uP DIAGNOSTICS tape from the tape rack and mount it on unit at 
tho load point. Push, in sequence, the Reset, Program Load, and continue 
buttons on the Nova front panel. You will probably have to free up some disk 
space by deleting extraneous Nova files before loading In the diagnostics. 
Then load the record labelled "*.MB" on the tape jacket: 
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LOAD/A/V MT0:n <cr> 

You must get the blue-covered, Vclo-bound book labelled "Microprocessor 
Diagnostics" 1n order to do any useful debugging. However, the diagnostics 
all fall Into a common pattern and they can usually be run 1n a simple-minded 
way without understanding too nuth about what the programs are really doing. 
The following general l2at Ions may be helpful. 

Associated with each of the diagnostics described below 1s a command file 
whose name Is the concatenation of "R" and the diagnostic name. If you type 
to DOS: 

MIDAS Rdlagname <cr> 

Midas will load the diagnostic and open registers pertinent to the 
diagnostic's operation on the Infoton display. You may wish to set some 
parameters before starting a diagnostic (for example, the low and high 
addresses for a memory test). However, the values as loaded are reasonable 
for thorough testing. 

When you are ready, type 5TART;G to start the diagnostic. (DGM has two 
alternate starting addresses for interrupt system testing.) The diagnostic 
will halt after one pass at IHA=20 (DGIML is the only exception to this rule). 
This means that no failures were detected. To repeat, type ;P to Midas. To 
loop indefinitely, delete the breakpoint at 20 by typing 20;K and then ;P. 
All of the diagnostics except DGM loop in less than two seconds, so something 
1s wrong if the machine hangs in the loop. 

A breakpoint at any location except 20 indicates that an error was detected. 
The most common error breakpoint is at 26, which Is the comparison error 
breakpoint. The location in the diagnostic from which the comparison routine 
was called Is displayed at STK 0. The .IS listing for each diagnostic gives 
address symbols and their values, sorted In order of value so that the symbol 
nearest the error address may be found readily (you normally are Interested In 
IM memory addresses only). Following the .L5 listing 1s the diagnostic 
listing, which contains general operating Instructions in comments preceding 
the program Itself. DBEGO is assembled or loaded ahead of some diagnostics, 
so Its listing and .LS file may also be relevant. Some diagnostics INSERT 
other files or are assembled from several sources, so you may have to look a 
bit to find the relevant listings. When tracing an error, find the tag 
nearest the address in STK (if the breakpoint is at IMA=26) or IMA (If the 
breakpoint is elsewhere) and read the comments there from the listing. 

If the breakpoint 1s at IMA=26, the diagnostic may be resumed from the point 
of error by the command RETN;G, which will return to the caller of the compare 
routine (this usually works but not always). 

One common problem that occurs when running diagnostics 1s that the 
microprocessor single steps and refuses to run. The usual cause of this Is a 
memory interface hangup, which at present can be cured only by running the GO 
program (type "6,G0;T" or "1;T" to Midas). If the machine hangs, run GO and 
see 1f that cures the problem. 

The diagnostic names and what they test are listed below: 



DG01.MB 



Most basic diagnostic. Does not use the main 
memory, the Interrupt system or the P-reglster 
Input multiplexors. Tests everything except the 
SM, DM, LM, and RM memories first, then tests 
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t.hp«;o mpnorles and the F-reg1ster. 
1 second. 



Cycle time < 



DGP.MB 



DGM. MB 



DGI.MB 



DGIML. MB/DGIMH. MB 



DGRL.MB 



DGMR.MB 



Tests the P-reglster Inputs and a few 
afterthoughts from DG01.MB. Cycle time < 1 
second. 

Tests the memory interfaces. There are alternate 
entry points at START and XSTART for interrupt 
system testing. Be sure to read the listing 
conmnnts before starting at XSTART. Cycle tine - 
40 minutes to test all 256K of main memory; 
correspondingly less If the address range is 
restricted. 

Tests the interrupt system and repeats parts of 
DG01 and DGP affected by Interrupts. Cycle time 
< 1 second. 

Test the SM, DH, and MP memories using random 
numbers, then the Instruction memory (IM) first 
by using each of the 72 patterns of a single In 
a field of l's, then the 72 patterns of a single 
1 in a field of 0*s, then random numbers. Cycle 
time < 3 seconds. 

Tests the right register bank (RM) and the left 
register bank (LH) using random numbers. Cycle 
time < 1 second. 

Tests the main memory using random numbers* 
Cycle time - 20 seconds. 



The diagnostics are assembled according to the instructions 1n the listings. 

If you have to patch the microprograms to setup a scope loop, you will need 
familiarity with the microlanguage. The following pointers may help. The .ST 
files needed for patching are usually deleted after assembly because they 
won't nil fit on the disk. If you need one, simply reassemble the 
microprogram. Since patching requires more disk storage, you may have to 
delete something from the file directory. Then reload the microprogram and do 
a 4,FILE;T to attach the .ST file and then use the E macro to make the patch. 
For example, to change the third Instruction after LOOP type to Hides 

<sp>E[3,LOOP]; GOTO[ . -2];<cr> 

or whatever. Then run with START;G 

Diagnostic sources are maintained in the Tenex <ERF> directory. There are 
Tenex command files for producing a cross reference listing and for dumping 
the sources onto a magtape for transport to the Nova file system where they 
are assembled and loaded. The contents of the command files are also printed 
1n the "Microprocessor Diagnostics" book. 
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19. [Running PDP-10 Diagnostics] 



19. IT [Standalone] 



19.2. [Under Tenex] 



20. [Hardware Maintenance Procedures] 



20.1. [TWEH3 



20.2. [TR1 



21. Writing a New 10SYS Tape 



If any system files have been changed, they should exist on the Nova disk 
prior to beginning the following procedure. 

A. Mount the current 10SYS tape on unit 0. (You must use magtape unit for 
10SYS tapes since 00S will not handle any other drive.) 



B . Type : 



XFER MT0:0 TBOOT.SV <cr> 



C. If NSYS.SV Is not already on the Nova disk, type: 

XFER HT0:l NSYS.SV; CHATR NSYS.SV SPW; INSTALL NSYS.SV <cr> 

D. Free up disk space consumed by the program overlay feature by re-boot1ng 
DOS (push, in sequence, the "Reset", "Program Load", and "Continue" switches 
on the Nova front panel). Then load the most recent BASEF, SYSF, and CHANGEF 
records from the tape (consult the label on the tape Jacket). E.g., 

IOAD/A/V MT0:(2,7,13) <cr> 
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if tho newest. BAM F , SYSF. nnrl CHANGEF files are on records Z, 7, and 13. 
Most of these files will undoubtedly already exist on the disk and will not be 
overwritten (Hie message "file already exists" will be printed out for these). 

E. Mount the new tape, with a write ring In it. 

F . Type : 

XFI.R TBOOT.SV MT0:0; XFER NSYS.SV MT0:1 <cr> 
DUMP/A/V MT0:2 PBASFFP <cr> 
DUMP/A/V MT0:3 <?SYSF(? <cr> 
DUMP/A/V MT0:4 @CHANGCF(? <cr> 

6. Check that everything is written ok by typing: 

LOAD/V MT0:(2,3,4) <cr> 

"File already exists" should be printed for every file. 

H. Remove write ring, label tape Jacket. 



22 . Recovery from Checkdsk Errors 



As explained in Section 7, when Tenex 1s restarted, whether initially or due 
to nn nuto-rcstart after a crash, the programs Bsys and Checkdsk are run to 
verify tho consistency of the file system. If either of these programs 
detects errors which cannot be corrected automatically, the message 'Tenex not 
available: Disk needs fixing" is broadcast to all terminals instead of the 
usual "Tenex in operation" message, and logins are prohibited from all 
terminals except the two in the Maxc room. 

The following procedures require wheel or operator status and are intended 
principally for reference by system personnel. With some assistance from a 
user In the Maxc room, a system malntainer can perform these procedures from a 
home terminal. Only 1n extreme circumstances should non-system personnel 
attempt any of these procedures. 

Errors detected by Bsys (which are usually reflected by some further errors 
detected by Checkdsk) Indicate inconsistencies 1n the structure of user file 
directories. Fixing these requires a fairly intimate knowledge of the Tenex 
directory structure; this should be left to system personnel. 



Checkdsk errors come 1n a number of guises. 
will be printed as 1n the following example: 



For each file with errors, data 



10050172166 MDA 
1400!>0172170 MDA 63 
<NIELY>MESSAGE.C0PY;3 

1 PTE 

2 MDA 



} List of errors 

} 

Filename 

} Error 

} summary 



If there are many errors in a single file, Checkdsk will print out only tha 
first few, followed by the filename and summary. Study the output carefully. 
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First, note that "NOT IN BT" errors have boon coj-jrectod by Cji[pckd_sk, so don't 
worry about then. If those were the only errors that occurred, Checkdsk 
wouldn't have conplalned and the system would have flown on. 

Next, note that you will have to use sone jyj1gem_ont In discriminating between 
garbaged page tables and real MDA errors. A file with a garbaged page table 
will have an pnornous error count ( 1n the hundreds) with many categories of 
errors (IDA, HDA, PTE, etc). This is frequently caused by an untimely Tenex 
crash occurring between directory update and page table update during new file 
creation, so that the page table for the file will not have been written on 
the disk yet and whatever was on that page before will be Interpreted as a 
page table. This type of error nay result 1n many other files getting bogus 
MDA errors because sone of the entries 1n the garbaged page table look like 
valid disk addresses that happen already to be assigned. 

For further confirmation that the problem 1s a garbaged (unwritten) page 
table, a QFD of the filename should reveal that 1t was created within a mliTOte 
or two before the tine of the last system crash. Such a file should be 
deleted using the following procedure: 

EENARLE <cr> 

(CONNECT <dircctory with bad f11e> <cr> 

! DELE TE <bad filena~ne> <cr> 

! EXPUNGE <cr> 

i 

This procedure causes the bad file to be expunged from the directory. A 
nunber of valid addresses possibly In use by oth-er files may be deallocated, 
but don't worry about this. The system will generate a number of BUGCHKs for 
Illegal disk addresses, but don't worry about this either. (Be sure DCHKSW 1s 
set to zero, however, to prevent the system from breakpolntlng on these 
errors). Run Checkdsk again after performing this surgery to make sure you 
did It right and that there is nothing else wrong. Checkdsk w1Tl reallocate 
pages Incorrectly deallocated by the preceding procedure and will type out 
•NOT IN B.T" for these. 

! CONNECT SYSTEM <cr> 

! C HECKDSK <cr> 

REBUILD BIT TABLE? N 

SCAN FOR OISK ADDRESSES? N 



(This currently takes about 10 minutes). 

After all files with garbaged page tables have been eliminated (If there were 
any), any further errors are considerably more serious, particularly MDA 
errors. MDA stands for multiply-allocated disk address, meaning that a 
particular page has somehow been assigned to more than one file. For each 
such error, Checkdsk has printed out the second file owning the page that 1t 
encountered In Its scan of the file system; you do not yet know the name of 
the other owner of that page. Hence you should follow this procedure: 

! CONNECT <d1rector y cjantajnjng file with MDA error) <cr> 

1 COPY <affectod filename") GARBAGE <cr> 

'DttJETE Offected filenam e) <cr) 

! EXPUNGE <cr> 

! RENAME GARBAGE <affected filename) <cr> 

Repeat this procedure for all affected files. You should be careful to type 
the <affected filename) 1n full, including version number, so you don't 
mistakenly fix up the wrong file. 
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Next, re-run Choi-.kdsk as explained above. While running, Checkdsk will type 
out a number of NOl IN 111 errors whoso disk addresses correspond to the disk 
addresses in the original MDA error printouts; the filenames typed out will 
bo those of the other owners of the pages that were multiply assigned. It nay 
not bo obvious which "owner of a page has the correct copy (a QFD of the 
filenames will include the write dates, which nay give sone Indication; I.e. 
the file with the newer write date is more likely to have the correct data), 
but you have done the best that can be done by giving non-conf 1 1ct1ng copies 
to everybody Involved. Use SNDMSG to notify all users who have (potentially) 
lost files. Both the original MDA and the final NOT IN BT files are Involved 
In the loss. 

When you have pieced the filesystem back together to what you believe Is a 
reasonable state, you should operi the system to users by the following 
procedure: 

•nun <cr> 

./ " 

FACTSW/ 500000,, 

<cnntrol-P) 

ABORT 

. t_ 

•rOGOJJT <cr) 

LOGOUT USER 

<control-C) 

After you type control-C, the auto-jobs should start logging in, and shortly 
thereafter "Tehex in operation" will be broadcast. 



400000,, <cr) 



23. [Tcncx File System Maintenance] 



23.1. [Bsys O peration] 



23.2. [Creating and De stroying Directories] 



23.3. [Format of System Directory and Index] 



23.4. [Fixin g Smashed Directories] 
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24 . [Assenbly Procedure s] 



24.1. [Ter.^x] 



24.2. [NVIO] 



24.3. [Microcode] 



